Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / MODEMPRO / TELESHAR.ZIP;1 / DOCHELP@.EXE / XM.DOC < prev

Wrap

Text File | 1993-07-27 | 14.9 KB | 374 lines

TeleShare DOS Remote Access XM or XMODEM Page 1 This Product is Shareware, if you continue to use it Please Legalise your usage through Registration. _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| Member Table of Contents 1. File Transfer 2. Automatic File Transfer 3. Creating Batch File(s) for Automatic Transfer(s) FILE TRANSFER TeleShare primarily uses a stand-alone DOS program called XM.EXE (indicating a version of the XModem protocol) to perform file transfers. This is in keeping with maintaining a small memory footprint in the PCs' limited available RAM. You can also use other external file transfer programs as described elsewhere in this distribution. XM.EXE is run from the DOS command line and runs as dependent child process of the TeleShare Host/Remote modules. XM.EXE will ONLY transfer files between 2 TeleShare systems. It is written specifically to get along with the TeleShare TSR's. Using XM.EXE, with the XModem protocol, is akin to the DOS COPY command but differs in important ways as follows: Let's say that you are using TeleShare on two PCs and would like to transfer a file called RESULTS.TXT from the Host PC to your local machine. 1. While accessing the REMOTE HOST change to the area on that machine where XM.EXE is located. This is not necessary if XM.EXE is in a sub-directory listed in the current PATH or environment statement(s) on the HOST PC where the system can easily find it for you. 2. Enter 'XM S RESULTS.TXT' at the DOS prompt. Add any PATH TeleShare DOS Remote Access XM or XMODEM Page 2 characters necessary if RESULTS.TXT is not in the default sub-directory. If XM.EXE is in the \TELE subdirectory, you can use '\TELE\XM S RESULTS.TXT' The 'S' stands for 'SEND'. 3. If the file is found then the screen will clear and you will be informed that you have a certain amount of time to exit to your LOCAL DOS and run your own XM.EXE to receive the file. 4. When the message appears that the HOST is ready to SEND press ALT-L ( or whatever you have set the hotkey to) and exit to your own local DOS. Change to the area on your LOCAL PC where XM.EXE is located and enter 'XM R'. This will allow the file to be RECEIVED into the default sub-directory with the same name as the file being sent. (You can change the name during the transfer. See below). 5. The Transfer progress screen will appear and show the progress of the file transfer. Once back at your own local DOS prompt when the transfer is finished. 6. When the transfer is completed then simply press ALT-R ( or whatever you have set the hotkey to ) and return to the REMOTE HOST session. You will see the same transfer screen you saw locally on the REMOTE HOST. It will say 'SEND' instead of 'RECV' in the upper left corner of the screen. This allows you to discover what the other side had to say about the progress of the transfer (just in case gremlins attacked). Simply clear the screen (CLS) and continue your session normally. How to use the XM.EXE Command format XM [R or S] [ somefile ] XM This is the transfer program itself, unless you have renamed it. R or S The first parameter should be 'S' if XM is to SEND files. The first parameter should be 'R' if XM is to RECEIVE files. somefile File(s) to be transferred. Wildcards are OK when 'S' is used to SEND files. '*.DBF' is a wildcard for all the dBase files ending in .DBF in the current directory. If you are RECEIVING files then this parameter is optional. You can simply enter 'XM R' and all files will be received using the SAME name as the one sent. This works whether it's 1 or 100 files being sent. If you are RECEIVING one file only and you wish to change its name on your side then go ahead and enter the desired new_filename after the 'R' parameter. When the name arrives from the HOST the transfer box will tell you that it's TeleShare DOS Remote Access XM or XMODEM Page 3 'Receiving ORIGINAL_NAME as NEW_NAME'. 'NEW_NAME' will appear in your local directory. If you are receiving more than 1 file then you cannot enter an alternate filename after the 'R' parameter. You must receive ALL the files using the names sent. Some important reminders... - You MUST separate the XM parameters with SPACES, so it will not become confused trying to find 'Ssomefile' when it should just be using the Send command to send the 'somefile'. - You cannot enter a LIST of different filenames one after the other in this version. Groups of files can only be sent if they can be distinguished with any normal DOS wildcard directory command. - If your LOG files option is ON then the progress and results of each 'XM' request will be appended to either XMSEND.LOG or XMRECV.LOG. - You cannot access the remote PC while transferring files. XM is a stand-alone DOS program ( non- multitasking ) and it must be terminated before you can have a HOTSCREEN session with the HOST. The HOTKEY will work but you will NOT establish contact with the remote HOST while a transfer is in progress! Other similar software will let you do both at the cost of slowing down the transfer, the normal session, and both computers. If your personal time or toll charges are important consider separating the sessions in some way. You can put file transfers at the beginning or the end of the session while you do something else, or you can setup an automatic tranfer when the toll charges are lower. Aborting the File Transfer You can ABORT the transfer(s) at any time by pressing the ESC key. The standard xmodem CANCEL signal will be sent to the other system and you will return to your own local DOS. Automatic File Transfer With the proper batch file and the use of WAIT.EXE or a similar task suspension program you can use XM.EXE to transfer files when nobody is around and toll/billing charges are possibly lower. Use the normal XM R and XM S commands but you need to add the letter 'A' after the 'R' or 'S' to indicate this is an TeleShare DOS Remote Access XM or XMODEM Page 4 Automatic transfer. Example: XM SA *.DAT - Send ALL .DAT files automatically! Why the 'A'? The normal transfer start timeouts are set for manual operation and are based on seconds. The 'A' causes these timeouts to be based on minutes so that the PC's involved have a longer chance to establish the connection. This allows the transfer to be set for a specific time of day and it won't matter if the P.C.'s clock times do not match. The default WAIT is 2 minutes when 'A' is added to 'R' or 'S'. You can increase or decrease the number of minutes by adding the desired number following the letter 'A'. Do NOT separate the number from the letters with a space. Example command line entries... XM SA RESULTS.TXT - Send the file automatically and wait 2 minutes (default) before giving up. XM SA5 RESULTS.TXT - Send the file automatically and wait 5 minutes before giving up. XM RA - Wait 2 minutes to start receiving all files being sent by the other side. XM RA10 - Wait 10 minutes to start receiving all files being sent by the other side. XM SA 8 RESULTS.TXT - WRONG!! This will NOT wait 8 minutes before giving up... it will wait only 2 minutes and will try to send a file called '8'! Do not separate time with spaces. The minimum value you can specify after the 'A' is '1' (1 minute). If you are using the transfer LOG files then a special entry will be made whenever an automatic transfer is initiated to inform you that that's how the transfer was made. Creating batch files to perform automatic transfers ================================================================ If the TeleShare TSRs are loaded and running on BOTH PC's and the current PATH includes both XM.EXE and the files to be transferred then the following 2 batch files will perform an automatic transfer at 11:00 pm. Both sides will wait 5 minutes for the transfer to kick off before giving up in case the clocks are a little off, as 'cheap insurance'. TeleShare DOS Remote Access XM or XMODEM Page 5 NOTE: See the documentation concerning WAIT, ET, or the particular timer command that you will use for more information about timing the transfer. Sender Explanations Receiver ------------ ----------------------------- --------- cls <-Clear the screen ---------> cls wait 11 PM <-Wait until 11:00 PM ------> wait 11 PM XM SA5 *.DAT <-Wait 5 mins then transfer-> XM RA5 If the TeleShare programs are NOT loaded on the 2 PC's then the batch file can be sure they are before performing transfer. Assuming the files are in a sub-directory called \TELE on the C: drive. Sender Explanations Receiver ------------ --------------------------------- --------- wait 11 PM <-Wait until 11:00 PM ----------> wait 11 PM cls <-Clear the screen -------------> cls c: <-Be sure we are on drive C: ---> c: cd\TELE <-Change to TeleShare directory-> cd\TELE call TSHOST <-Call batch files for the TSR's> call TSREM cd\transfer <-dir holding SEND/RECV files---> cd\transfer XM SA5 *.DAT <-Wait 5 mins then transfer -> XM RA5 cd\TELE <-Return to TeleShare directory-> cd\TELE TSH U <-Unload the TSR's from RAM ----> TSR U Remember to use the batch file 'call' command if you are loading the programs with the normal batch files or batch file execution will stop after the TSHOST or TSREM batch file is run. Run 'TSH' or 'TSR' directly in the same batch file if you don't want to use CALL in batch files to load the programs. You can put multiple 'XM' commands in the batch file(s) to send groups of files and switch between xmodem sender and receiver. Examples: Assuming the TeleShare programs are already loaded. Sender Explanations Receiver -------------- ------------------------------ ---------- cls <-Clear the screen ----------> cls wait 11 PM <-Wait until 11:00 PM -------> wait 11 PM XM SA5 *.DAT <-Send all *.DAT to receiver-> XM RA5 XM SA5 *.TXT <-Send all *.TXT to receiver-> XM RA5 XM SA5 *.DOC <-Send all *.DOC to receiver-> XM RA5 XM SA5 TEST.EXE <-Send TEST.EXE to receiver-> XM RA5 XM RA5 <----- Send *.COM to sender--> XM SA5 *.COM XM RA5 <----- Send *.BAK to sender--> XM SA5 *.BAK XM SA5 *.DBF <-Send all *.DBF to receiver-> XM RA5 TeleShare DOS Remote Access XM or XMODEM Page 6 Support and the ASP For technical support, either call (604) 433-5189, or write to Suite 606 - 6455 Willingdon Avenue, Burnaby, British Columbia, Canada, V5H 4E4. Both registered and soon to be registered users currently get the same support without any arbitrary time limit. You may also try leaving a Compuserve message at 75020, 2664. ASP Introduction: Please also carefully read the accompanying SHR_WARE.DOC document. "This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536." Please read the TSRTSH.DOC file for more information, including contact and support information. This document and associated TeleShare documents and software are Copyright (C)1992 P. C. Softsmith All Rights Reserved. THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED AND SOLD WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING ITS MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE. THE INFORMATION IN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE AND DOES NOT REPRESENT A COMMITTMENT ON THE PART OF THE VENDOR. OTHER PRODUCT AND BRAND NAMES MENTIONED ARE TRADEMARKS OR REGISTERED TRADEMARKS OF THEIR RESPECTIVE HOLDERS.